package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.smart.community.work.entity.Attendance;
import com.smart.community.work.vo.AttendanceVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDate;
import java.util.List;
import java.util.Map;

/**
 * 考勤记录Mapper接口
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Mapper规范实现：
 * - 继承BaseMapper：获得基础CRUD方法
 * - 方法命名：使用动词+名词形式，语义明确
 * - 参数注解：使用@Param注解标注参数
 * - 返回类型：使用具体的返回类型，避免使用Object
 * - 完整注释：所有方法都有完整的JavaDoc注释
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 * 
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface AttendanceMapper extends BaseMapper<Attendance> {

    /**
     * 分页查询考勤记录
     * 
     * @param page 分页参数
     * @param userId 用户ID（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @param status 状态（可选）
     * @return 分页结果
     */
    IPage<AttendanceVO> selectAttendancePage(Page<AttendanceVO> page,
                                             @Param("userId") Long userId,
                                             @Param("startDate") LocalDate startDate,
                                             @Param("endDate") LocalDate endDate,
                                             @Param("status") Integer status);

    /**
     * 根据ID查询考勤记录详情
     * 
     * @param id 考勤记录ID
     * @return 考勤记录详情
     */
    AttendanceVO selectAttendanceById(@Param("id") Long id);

    /**
     * 查询用户今日考勤记录
     * 
     * @param userId 用户ID
     * @param attendanceDate 考勤日期
     * @return 今日考勤记录
     */
    AttendanceVO selectTodayAttendance(@Param("userId") Long userId, 
                                       @Param("attendanceDate") LocalDate attendanceDate);

    /**
     * 查询用户考勤统计
     * 
     * @param userId 用户ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 考勤统计信息
     */
    Map<String, Object> selectAttendanceStatistics(@Param("userId") Long userId,
                                                   @Param("startDate") LocalDate startDate,
                                                   @Param("endDate") LocalDate endDate);

    /**
     * 根据用户ID查询考勤记录列表
     * 
     * @param userId 用户ID
     * @param propertyCompanyId 物业公司ID（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 考勤记录列表
     */
    List<Attendance> selectByUserId(@Param("userId") Long userId,
                                   @Param("propertyCompanyId") Long propertyCompanyId,
                                   @Param("startDate") LocalDate startDate,
                                   @Param("endDate") LocalDate endDate);

    /**
     * 根据物业公司ID查询考勤记录列表
     * 
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 考勤记录列表
     */
    List<Attendance> selectByPropertyCompanyId(@Param("propertyCompanyId") Long propertyCompanyId,
                                              @Param("startDate") LocalDate startDate,
                                              @Param("endDate") LocalDate endDate);

    /**
     * 查询指定日期的考勤记录列表
     * 
     * @param attendanceDate 考勤日期
     * @param propertyCompanyId 物业公司ID（可选）
     * @return 考勤记录列表
     */
    List<Attendance> selectByAttendanceDate(@Param("attendanceDate") LocalDate attendanceDate,
                                           @Param("propertyCompanyId") Long propertyCompanyId);

    /**
     * 查询迟到记录
     * 
     * @param propertyCompanyId 物业公司ID（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 迟到记录列表
     */
    List<Attendance> selectLateRecords(@Param("propertyCompanyId") Long propertyCompanyId,
                                      @Param("startDate") LocalDate startDate,
                                      @Param("endDate") LocalDate endDate);

    /**
     * 查询早退记录
     * 
     * @param propertyCompanyId 物业公司ID（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 早退记录列表
     */
    List<Attendance> selectEarlyRecords(@Param("propertyCompanyId") Long propertyCompanyId,
                                       @Param("startDate") LocalDate startDate,
                                       @Param("endDate") LocalDate endDate);

    /**
     * 查询缺勤记录
     * 
     * @param propertyCompanyId 物业公司ID（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 缺勤记录列表
     */
    List<Attendance> selectAbsentRecords(@Param("propertyCompanyId") Long propertyCompanyId,
                                        @Param("startDate") LocalDate startDate,
                                        @Param("endDate") LocalDate endDate);

    /**
     * 查询加班记录
     * 
     * @param propertyCompanyId 物业公司ID（可选）
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 加班记录列表
     */
    List<Attendance> selectOvertimeRecords(@Param("propertyCompanyId") Long propertyCompanyId,
                                          @Param("startDate") LocalDate startDate,
                                          @Param("endDate") LocalDate endDate);

    /**
     * 统计各状态考勤数量
     * 
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 状态统计信息
     */
    List<Map<String, Object>> selectStatusStatistics(@Param("propertyCompanyId") Long propertyCompanyId,
                                                    @Param("startDate") LocalDate startDate,
                                                    @Param("endDate") LocalDate endDate);

    /**
     * 统计各状态考勤数量（兼容方法）
     * 
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期（可选）
     * @param endDate 结束日期（可选）
     * @return 状态统计信息
     */
    List<Map<String, Object>> selectAttendanceStatusStatistics(@Param("propertyCompanyId") Long propertyCompanyId,
                                                              @Param("startDate") LocalDate startDate,
                                                              @Param("endDate") LocalDate endDate);

    /**
     * 统计用户月度考勤
     * 
     * @param propertyCompanyId 物业公司ID
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 月度考勤统计
     */
    List<Map<String, Object>> selectMonthlyAttendance(@Param("propertyCompanyId") Long propertyCompanyId,
                                                     @Param("startDate") LocalDate startDate,
                                                     @Param("endDate") LocalDate endDate);

    /**
     * 检查用户指定日期是否已有考勤记录
     * 
     * @param userId 用户ID
     * @param attendanceDate 考勤日期
     * @return 是否存在记录
     */
    Boolean existsByUserIdAndDate(@Param("userId") Long userId, @Param("attendanceDate") LocalDate attendanceDate);

    /**
     * 更新考勤状态
     * 
     * @param id 考勤记录ID
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer updateStatus(@Param("id") Long id, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 更新考勤时间
     * 
     * @param id 考勤记录ID
     * @param checkInTime 签到时间
     * @param checkOutTime 签退时间
     * @param workHours 工作时长
     * @param overtimeHours 加班时长
     * @param lateMinutes 迟到分钟数
     * @param earlyMinutes 早退分钟数
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer updateAttendanceTime(@Param("id") Long id,
                                @Param("checkInTime") java.time.LocalDateTime checkInTime,
                                @Param("checkOutTime") java.time.LocalDateTime checkOutTime,
                                @Param("workHours") java.math.BigDecimal workHours,
                                @Param("overtimeHours") java.math.BigDecimal overtimeHours,
                                @Param("lateMinutes") Integer lateMinutes,
                                @Param("earlyMinutes") Integer earlyMinutes,
                                @Param("status") Integer status,
                                @Param("updateBy") Long updateBy);

    /**
     * 批量更新考勤状态
     * 
     * @param ids 考勤记录ID列表
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer batchUpdateStatus(@Param("ids") List<Long> ids, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 删除考勤记录
     * 
     * @param id 考勤记录ID
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer deleteById(@Param("id") Long id, @Param("updateBy") Long updateBy);

    /**
     * 批量删除考勤记录
     * 
     * @param ids 考勤记录ID列表
     * @param updateBy 更新人ID
     * @return 删除数量
     */
    Integer batchDelete(@Param("ids") List<Long> ids, @Param("updateBy") Long updateBy);
}
